3D Graphics Programming with QuickDraw 3D 1.5.4

Managing Pixmap Textures

QuickDraw 3D provides routines that you can use to create and manipulate pixmap textures.

Q3PixmapTexture_New

You can use the Q3PixmapTexture_New function to create a new pixmap texture.



 
TQ3TextureObject Q3PixmapTexture_New (const TQ3StoragePixmap *pixmap);

pixmap: A storage pixmap.

DESCRIPTION

The Q3PixmapTexture_New function returns, as its function result, a new texture object that uses the storage pixmap specified by the pixmap parameter. If Q3PixmapTexture_New cannot create a new pixmap texture object, it returns the value NULL .

Q3PixmapTexture_GetPixmap

You can use the Q3PixmapTexture_GetPixmap function to get the pixmap associated with a pixmap texture object.



 
TQ3Status Q3PixmapTexture_GetPixmap (

                     TQ3TextureObject texture, 

                     TQ3StoragePixmap *pixmap);

texture: A pixmap texture object.
pixmap: On exit, the storage pixmap currently associated with the specified pixmap texture object.

DESCRIPTION

The Q3PixmapTexture_GetPixmap function returns, in the pixmap parameter, the pixmap currently associated with the pixmap texture object specified by the texture parameter.

Q3PixmapTexture_SetPixmap

You can use the Q3PixmapTexture_SetPixmap function to set the pixmap associated with a pixmap texture object.



 
TQ3Status Q3PixmapTexture_SetPixmap (

                     TQ3TextureObject texture, 

                     const TQ3StoragePixmap *pixmap);

texture: A pixmap texture object.
pixmap: The storage pixmap to be associated with the specified pixmap texture object.

DESCRIPTION

The Q3PixmapTexture_SetPixmap function sets the pixmap to be associated with the pixmap texture object specified by the texture parameter to the pixmap specified by the pixmap parameter.